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INIROQUCTION 


The lo_catt| command current!y provides complete faciilties 
at command fevel for performing ati possibile operations on a 
single I/0 switchs, with the exception of lox_$control requiring 
an information pointer. As such, it provides an extremely useful 
tool for setting up user program Input/output switches, and (for 
debugging programs and I/0 modutes. 


The major facitity It does not provide is a copy faclltity. 
There Ils a need to copy from one swifch to another, elther untli 
the Input switch exhausts the input sources, or until a certain 
number of read/write operations have been performed. 


A suitch-to-switch copy facility would support fitle-to-tape 
operations through any of the tape I[/0 modules, file-to-disk 
operations through the disk I/0 mecdufes and special-purpose 
flle-to-printer, card reader-to-flie, and file-to-card punch 
operations. As such, it would be a useful toot for debuggings 
and for quick copy operations between various medla. 


INTERFACE 
See the attached draft MPM documentation. 


CRITICISH 


The above interface can copy from or to any type of fife 
except for keyed sequential files. One can argue that these are 
onfty supported by the storage system (vflte_) currently, and can 
be copled with the copy command. . 


An alternate proposal would use 2 -keyed control argument fo 
signify that both the Input and oufput fifes were keyed 
sequential. The Input file would be opened for 
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keyed_sequentialt_iInput and the output file for 
keyed_sequentilal_output. Records and their keys could then be 
read with read_key/read_record operations, and written with 
seek_key/write_record operations. 


Given the tinalted use of keyed files and the avalfabliity of 
the copy command, It is probably unnecessary for fille copy to 
provide this tevel of support. Note that the Interface does 
permit a keyed sequential input file to be read and copied in a 
sequential manner. 


While the Interface can copy unstructured files, the 
record stream_ I/G0 module Is required as an Intermediary. 
Although the transformation function could concelvably be 
Integrated with file _copy, the record _stream_ I/0 module was 
specifically designed to effect this type of converslon, and 
there Is no need to dupticate its functlon within the flle_copy 
command. | 
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Nages?: fite copy, fe 


This command coples records from an input fllte to an output 
file. The input and oufnput file types must be sequentlal. (See 
Unstructured Filles end Keyed Flless below, for an explanation of 
how these types of filles may be copied.) The input file may be 
copled elther partially. or in its entirety. 


Usage 
| file_copy input _spec output spec -control_args- 
where? 
te input_spec specifles the Input file from which records 


are read. It may be either an I/0 switch 
name, or an attack description. (See Notes, 
betown.) 


-input_swltch switchnane 

-Isw switchname 
specifles the Input flfie by means of an 
already attached I/0 switch name, switchnane. 


-Input_fite Xxx 
~-I1f XXX specifies the inreut file by means of an 
attach descriptions XXX. 


Ze output_spec specifies the output flie to which these 
records are written. It may be either an 1I/0 
sultch name, or an attach description. (See 
Notes, betow.) 


-output_saltch swiftchname 

-osw sultchnane 
speclfiles the output file by means of an 
already attached 1/0 switch name, switchname. 


-output_fite XXx 
-of XXX specifies the output file by means of an 
attack descriptions XXX. 


3e controt_args may be one or more of the following optional 
control arguments (see Notes, below)? 


-frose I 

-fa I specifles that records are copied beginning 
“ith the Ith record of the Input flle. I 
must be a positive integer. The defautt is 
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to begln copying with the “next record”. 
(See Notes, below.) 


“to J specifles that copying is performed until! the 
Jth record has been copled, or the Input file 
exhausted, whichever occurs first. If this 
option is specified, <-from wsust saiso be 
specified. J must be a positive Inteser, 
greater than or equal to I. 


“count N 

-ct N specifies that copying is performed until N 
records have been copied, or the Input file 
exhausted, whichever occurs first. N aust be 
a positive integer. 

“allt, -a specifies that records are copled untli the 
input flie is exhausted. This Is the 
default. 

-brief, <-bf specifies that tre message Indicating the 
number of records actually copled Is to be 
suppressed. 

“longs, -lg specifies that a message Indicating tre 
number of records actually copled Is to be 
printed. This is the default. 

Unstructured Files 


flle_copy operates by performing record I/0 on = structured 
files. If it is desired to copy from/to an unstructured flie, 
the record_stream_ I/0 module may usede @ege 


file_copy -lf record_streaa_ -target vfile_ pathname -osw OUT 


The effect Is to take tines from the file specified by pathnane 
via vflle_» transform them into records yjlqa record_stream_» and 
then copy them to the I/0 switch nasaed OUT. 


Keyed Files 


file copy processes onty the sequentia! type of structured 
file. The copy command may be used to copy indexed sequential 
storage system files preserving keys. (See the MPM write-up of 
the copy command. ) However, file copy may be used to copy an 
Indexed sequential input file In a sequential sanner 


(disregarding keys). Note that the outnut fite tyne Ise 
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sequential, not indexed sequential. 


Notes 


If elther the Input or output specification Is an attach 
description, it Is used to attach an uniquely-named I/0 switch to 
the fite. The switch Is opened for sequentia!_Input or 
sequential_output, the copy perforsed, and then closed and 
detached. If an attach description contains any of the control 
arguments used by file copy, then it must be quoted. 
Alternatefy,s an 1/0 switch may be aftached using the lo_call 
command, and the flte specified by means of the I/0 switch name. 
(See the MPM write-up of the io cali conmand.) 


If the input file is specified by an I/0 switch name and the 
switch Is not open, flie copy opens it for sequential _iInput, 
perforas the copys and closes ite If the switch Is already open 
when fite_copy Is Invoked, If Is not closed after the copy has 
been performed; the file is teft positioned imnediately after 
the fast record copled. 


If the <-from controft argument is not used to specify an 
absolute starting position within the input file, copying besins 
with the “next record”. If the I/0 switch Is opened by 
flte_copy,. the next record is the first record of the flie$§ 
otherwise, the next record is that record at which the flie Is 
positioned when file_copy Is invoked. 


If the output fife Is specified by an I/0 switch name and 
the switch Is not opens file _copy opens If for sequentlal_output, 
perforas the copy, and cioses it. If the switch is already open 
when fllie_copy is Invoked, it is not closed after the copy has 
been performed; the fifte is left positioned Immedilatety after 
the fast record coplede 


The -brief and <-fiong control argquaents ere mutualiy 
exciusivee The copy count message appears as follows’ 


fite_copy: 345 records copled. (EOI) 


The appearance of EOI (End Of Information) Indicates that the 
fast record copled was the last record In the input file. 


The -to, -count, and -alt contrat! arguments are mutuality 
exctusive. 
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